home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / SLAX 6.0.8 / slax-6.0.8.iso / slax / base / 006-devel.lzm / usr / include / parted / exception.h < prev    next >
Encoding:
C/C++ Source or Header  |  2008-03-16  |  3.7 KB  |  117 lines
  1. /*
  2.     libparted - a library for manipulating disk partitions
  3.     Copyright (C) 1999, 2000, 2007 Free Software Foundation, Inc.
  4.  
  5.     This program is free software; you can redistribute it and/or modify
  6.     it under the terms of the GNU General Public License as published by
  7.     the Free Software Foundation; either version 3 of the License, or
  8.     (at your option) any later version.
  9.  
  10.     This program is distributed in the hope that it will be useful,
  11.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13.     GNU General Public License for more details.
  14.  
  15.     You should have received a copy of the GNU General Public License
  16.     along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17. */
  18.  
  19. /**
  20.  * \addtogroup PedException
  21.  * @{
  22.  */
  23.  
  24. /** \file exception.h */
  25.  
  26. #ifndef PED_EXCEPTION_H_INCLUDED
  27. #define PED_EXCEPTION_H_INCLUDED
  28.  
  29. typedef struct _PedException PedException;
  30.  
  31. /**
  32.  * Exception type
  33.  */
  34. enum _PedExceptionType {
  35.     PED_EXCEPTION_INFORMATION=1,
  36.     PED_EXCEPTION_WARNING=2,
  37.     PED_EXCEPTION_ERROR=3,
  38.     PED_EXCEPTION_FATAL=4,
  39.     PED_EXCEPTION_BUG=5,
  40.     PED_EXCEPTION_NO_FEATURE=6,
  41. };
  42. typedef enum _PedExceptionType PedExceptionType;
  43.  
  44. /**
  45.  * Option for resolving the exception
  46.  */
  47. enum _PedExceptionOption {
  48.     PED_EXCEPTION_UNHANDLED=0,
  49.     PED_EXCEPTION_FIX=1,
  50.     PED_EXCEPTION_YES=2,
  51.     PED_EXCEPTION_NO=4,
  52.     PED_EXCEPTION_OK=8,
  53.     PED_EXCEPTION_RETRY=16,
  54.     PED_EXCEPTION_IGNORE=32,
  55.     PED_EXCEPTION_CANCEL=64,
  56. };
  57. typedef enum _PedExceptionOption PedExceptionOption;
  58. #define PED_EXCEPTION_OK_CANCEL        (PED_EXCEPTION_OK + PED_EXCEPTION_CANCEL)
  59. #define PED_EXCEPTION_YES_NO        (PED_EXCEPTION_YES + PED_EXCEPTION_NO)
  60. #define PED_EXCEPTION_YES_NO_CANCEL (PED_EXCEPTION_YES_NO \
  61.                      + PED_EXCEPTION_CANCEL)
  62. #define PED_EXCEPTION_IGNORE_CANCEL (PED_EXCEPTION_IGNORE \
  63.                      + PED_EXCEPTION_CANCEL)
  64. #define PED_EXCEPTION_RETRY_CANCEL  (PED_EXCEPTION_RETRY + PED_EXCEPTION_CANCEL)
  65. #define PED_EXCEPTION_RETRY_IGNORE_CANCEL (PED_EXCEPTION_RETRY \
  66.                        + PED_EXCEPTION_IGNORE_CANCEL)
  67. #define PED_EXCEPTION_OPTION_FIRST PED_EXCEPTION_FIX
  68. #define PED_EXCEPTION_OPTION_LAST PED_EXCEPTION_CANCEL
  69.  
  70. /**
  71.  * Structure with information about exception
  72.  */
  73. struct _PedException {
  74.     char*            message;    /**< text describing what the event was */
  75.     PedExceptionType    type;        /**< type of exception */
  76.     PedExceptionOption    options;    /**< ORed list of options that
  77.                            the exception handler can
  78.                            return (the ways an exception 
  79.                            can be resolved) */
  80. };
  81.  
  82. typedef PedExceptionOption (PedExceptionHandler) (PedException* ex);
  83.  
  84. extern int ped_exception;    /* set to true if there's an exception */
  85.  
  86. extern char* ped_exception_get_type_string (PedExceptionType ex_type);
  87. extern char* ped_exception_get_option_string (PedExceptionOption ex_opt);
  88.  
  89. extern void ped_exception_set_handler (PedExceptionHandler* handler);
  90. extern PedExceptionHandler *ped_exception_get_handler(void);
  91.  
  92. extern PedExceptionOption ped_exception_default_handler (PedException* ex);
  93.  
  94. extern PedExceptionOption    ped_exception_throw (PedExceptionType ex_type,
  95.                              PedExceptionOption ex_opt,
  96.                              const char* message,
  97.                              ...);
  98. /* rethrows an exception - i.e. calls the exception handler, (or returns a
  99.    code to return to pass up higher) */
  100. extern PedExceptionOption    ped_exception_rethrow ();
  101.  
  102. /* frees an exception, indicating that the exception has been handled.
  103.    Calling an exception handler counts. */
  104. extern void            ped_exception_catch ();
  105.  
  106. /* indicate that exceptions should not go to the exception handler, but passed
  107.    up to the calling function(s) */
  108. extern void            ped_exception_fetch_all ();
  109.  
  110. /* indicate that exceptions should invoke the exception handler */
  111. extern void            ped_exception_leave_all ();
  112.  
  113. #endif /* PED_EXCEPTION_H_INCLUDED */
  114.  
  115. /** @} */
  116.  
  117.